home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / cli / okami15.lzh / OKAMI15 / DOC / README < prev    next >
Text File  |  1992-09-20  |  8KB  |  234 lines
  1.  
  2.     ===============================================
  3.  
  4. @(#)      OKAMI SHELL VERSION 1.4 - KURZEINFÜHRUNG
  5.  
  6.     ===============================================
  7.             Stand: 19.9.92
  8.  
  9.  
  10.     **                    **
  11.     **    English readers please read    **
  12.     **    the 'english.doc' file        **
  13.     **                    **
  14.  
  15.  
  16. Okami-Shell ist eine Unix-ähnliche Kommandoshell für alle Atari ST-Rechner.
  17. Vorbild war die Unix-Bourne-Shell.
  18.  
  19. Sie arbeitet:
  20.     * mit jeder Speicherkonfiguration (auch mit 512KB)
  21.     * mit jeder Bildauflösung
  22.     * mit Diskette, Ramdisk und Festplatte
  23.     
  24. Beschränkungen:
  25.     * Der Start der Shell von Diskette ist möglich, aber wegen der
  26.       geringen Geschwindigkeit wird Ramdisk oder Festplatte empfohlen.
  27.     * Zur Benutzung der Pipe muß mindestens ein Laufwerk beschreibbar
  28.       sein. Dies muß nicht notwendig das Laufwerk sein, von dem die
  29.       Shell gestartet wurde.
  30.  
  31. Zum Starten der Shell:
  32.     * sh.ttp anklicken und als Parameter ein Minuszeichen angeben.
  33. oder:    * msh.prg anklicken.
  34.  
  35. Für Hilfe:
  36.     * "help" oder "cmds -C" eingeben.
  37.     * Die Help-Taste liefert eine Anleitung zu jedem internen Kommando.
  38.  
  39. Zum Beenden der Shell:
  40.     * "exit" eingeben.
  41. oder:    * Ctrl-D drücken.
  42.  
  43.     
  44. Das wichtigste in Kürze:
  45.     * Standard-Unix-Kommandos: cat, ls, cd, pwd, cp, mv, rm, rmdir,
  46.        df, pg, echo, grep, find, chmod, touch, date, mkdir, basename,
  47.        dirname, time, xargs, backup, if, while, shutdown,...
  48.     * über 100 eingebaute Kommandos
  49.     * eingebauter UPN-Rechner mit über 80 Funktionen
  50.     * Shell-Variablen setzen in der Form NAME=WERT
  51.     * Ausführung von der Shell als TTP-Parameterzeile übergebenen
  52.       Kommandos mit darauffolgender Beendigung der Shell möglich
  53.     * Aufruf über den _shell_p-Zeiger möglich, incl. Quellcode der
  54.       system()-Funktion
  55.     * Konfiguration der Shell durch eine nach Programmstart auszu-
  56.       führende Kommandodatei (Profile)
  57.     * Eingabe, Ausgabe und Fehlerausgabe aller interner Kommandos
  58.       umleitbar mit <, >, >>, 2>, 2>> für alle Programme, die
  59.       Ein- und Ausgabe auf Gemdos-Basis benutzen
  60.     * Simulation von Pipelining: Die Ausgabe eines Kommandos wird
  61.       zur Eingabe eines anderen; beliebig schachtelbar
  62.     * Command Substitution: z.B.
  63.       echo Der Basisname von $FILE ist `basename $FILE`
  64.     * Unix-Wildcards, z.B. a[bcd-f]*e?.[xy]? etc.
  65.     * Ausführung von Shellscripts (Batch-Files) mit Parameterübergabe
  66.     * Shellfunktionen = speicherresidente Shellscripts möglich; Shell-
  67.       funktionen können interne Kommandos umdefinieren (die ursprüng-
  68.       lichen Kommandos können trotzdem noch aufgerufen werden
  69.     * Shellfunktionen können auch mit der Tastatur eingegeben werden
  70.     * Binärprogramme können resident gehalten und über Shellfunktionen
  71.       gestartet werden
  72.     * Hash-Tabelle: die Pfade von aufgerufenen Programmen werden gespei-
  73.       chert und beim nächsten Aufruf ohne Suchen gefunden
  74.     * Tastatureingabe mit History (Zurückholen vorheriger Eingaben
  75.       per Tastendruck)
  76.     * Filename Completion und Substitution auf Tastendruck
  77.     * Alle Tasten inkl. F-Tasten frei mit Kommandos belegbar
  78.     * Suchen von Programmen auf konfigurierbaren Pfaden, mit
  79.       konfigurierbaren Extendern zur Erkennung ausführbarer
  80.       Programme
  81.     * Pfadangaben können wie in TOS (z.B. d:\shell\sh.ttp, getrennt mit
  82.       Backslash) oder Unix (z.B. d:/shell/sh.ttp, getrennt mit Slash)
  83.       angegeben werden
  84.     * Programmierung mit if und while, schachtelbar
  85.     * Terminal Server: der Rechner kann über eine beliebige Schnitt-
  86.       stelle ferngesteuert werden
  87.     * Eingebauter Terminal-Emulator
  88.     * Unterstützung von OverScan: OverScan kann per Shell-Kommando
  89.       ein- und ausgeschaltet werden
  90.     * Alle GEM-Programme sind von der Shell aus ausführbar
  91.     * Online-Help mit Syntaxerklärung aus einer editierbaren Datei
  92.     * Help-Taste liefert Anleitung zu jedem Kommando aus der Anleitungs-
  93.       Datei der Dokumentation (commands.doc, über 170 KB)
  94.     * Bildschirmschoner und Uhr auf Tastendruck
  95.     * Auswertung und Einstellung der Environment-Variablen
  96.     * Parameterübergabe per xArg möglich
  97.     * ausführliche deutsche Dokumentation (>300 KB) mit vielen Beispielen
  98.     * Software-Support bei Fehlern und Fragen, nicht gebunden an
  99.       die Zahlung von Anerkennungsbeiträgen etc.
  100.     und vieles mehr......
  101.  
  102. Das wichtigste in Beispielen:
  103.  
  104.     rm test.o        (Löschen einer Datei)
  105.  
  106.     cat test.txt        (Anzeige einer Datei)
  107.  
  108.     cd d:\shell\bin     (Wechsel des aktuellen Laufwerks und des
  109.                  aktuellen Directories)
  110.  
  111.     cd ..            (Wechsel ins Parent-Directory des aktuellen
  112.                  Directories)
  113.  
  114.     ls -ls d:\        (Ausführliche Dateiliste mit Attributen,
  115.                  Dateigröße und -Datum, sortiert nach der
  116.                  Dateigröße)
  117.  
  118.     ls -l d:\ >dir.txt    (Umleitung der Ausgabe)
  119.  
  120.     hd test.prg | pg    (Seitenweise Ausgabe eines Hexdump)
  121.  
  122.     date >>datum.log    (Anfügen des Datums an das Ende einer Datei)
  123.  
  124.     echo Bitte Name eingeben
  125.     read NAME        (Benutzung von Shellvariablen)
  126.     echo Der Name ist $NAME
  127.  
  128.     TMPNAME=dat$$.tmp    (Erzeugen eines eindeutigen Dateinamens
  129.                  durch die System-Shellvariable $, deren
  130.                  Wert sich ständig ändert [in Unix:
  131.                  Prozessnummer])
  132.  
  133.     PS1='Eingabe >'     (Ändern des Shell-Prompts)      
  134.  
  135.     a=`date`        (Einlesen des Datums in die Variable a)
  136.     echo Das Datum ist $a
  137.  
  138.     grep printf *.c     (Suchen von "printf" in allen C-Dateien)
  139.  
  140.     df C: E: F:        (Ausgabe der Plattenbelegungen)
  141.  
  142.     chmod +hr secret.dat    (Verstecken und Schreibschützen einer Datei)
  143.  
  144.     help | grep chmod    (Ausgabe der Syntax des Kommandos chmod)
  145.  
  146.     find d:\ -name test.* -print    (Ausgabe des Pfades aller Dateien namens
  147.                  test.* auf Laufwerk D:)
  148.  
  149.     pg $HOME\profile    (Seitenweise Ausgabe der Konfigurationsdatei)
  150.  
  151.     cursor 12        (Setzen der Cursor-Geschwindigkeit)
  152.  
  153.     mouse x y        (Abfrage der Maus-Koordinaten, Speichern der
  154.                  Werte in den Variablen x und y)
  155.  
  156.     fsel *.c test.c     (Auswahl einer Datei mit der Fileselect-Box)
  157.  
  158.     touch sh.c        (Erneuern des Dateidatums von sh.c)
  159.  
  160.     cls            (Bildschirm löschen)
  161.  
  162.     time test.tos        (Messen der Ausführungszeit eines Programmes
  163.                  auf 1/100 Sekunden genau)
  164.  
  165.     export TERM        (Übernahme der Variablen TERM ins Environment)
  166.  
  167.     find d:\ -name *.bak -exec "rm {}"    (Löschen aller *.bak-Dateien
  168.                        auf Partition D:)
  169.  
  170.     seek d:\ *.* | backup    (Sichern aller Dateien von Partition D:
  171.                  auf Diskette)
  172.  
  173.     seek e:\ *.* | xargs wc | pg  (Seitenweise Ausgabe der Anzahlen der
  174.                  Zeilen, Zeichen und Worte aller Dateien
  175.                  auf Partition E:)
  176.  
  177.     echo Auf A: sind `find A: -type x -print | wc -l` Dateien ausführbar.
  178.                 (Zählen der ausführbaren Dateien auf A:)
  179.     
  180.     df -mn | xargs seek {}\ *.* | wc -l
  181.                 (Zählen aller Dateien auf allen Laufwerken)
  182.  
  183.     upn 17 sqr pi *     (Berechnen der Oberfläche eines Kreises mit
  184.                  Radius 17)
  185.  
  186.     keydef F4 "dir *.c"    (Tastendefiniton: "dir *.c" wird auf die Taste
  187.                  F4 gelegt)
  188.  
  189.     rm test.dat ; echo test.dat ist gelöscht
  190.                 (Verkettung von Anweisungen)
  191.  
  192.     format            (Formatieren der Diskette in Laufwerk A:)
  193.  
  194.     format -t40 -s10 B:    (Formatieren von Diskette B: mit 40 Tracks
  195.                  und 10 Sektoren/Track)
  196.  
  197.     df(e:/newdf.sh)     (Laden der Datei e:/newdf.sh und Abspeichern
  198.                  als Shellfunktion, die anstelle des Komman-
  199.                  dos df benutzt werden kann; in der Datei
  200.                  kann das ursprüngliche Kommando df unter
  201.                  dem Namen !df benutzt werden)
  202.  
  203.         signum(e:signum2.prg)    (Laden und residenthalten von signum2.prg,
  204.                  Aufruf über die Shellfunktion "signum")
  205.  
  206.     while [...]        (Schleifenbildung und Programmierung)
  207.     do
  208.       ....
  209.       if [...]
  210.       then
  211.         ...
  212.       fi
  213.       break         (Abbruch der while-Schleife)
  214.       continue        (Neuer Schleifendurchlauf)
  215.     done
  216.  
  217.  
  218. Weitere Beispiele: siehe commands.doc und tricks.doc
  219.  
  220.  
  221. Dokumentation:
  222.  
  223.     readme            Kurzeinführung
  224.     release         Versions-Identifikation der Shell
  225.     okami.doc        Bedienung der Shell
  226.     english.doc        Kurzfassung davon auf Englisch
  227.     commands.doc        Bedienung der internen/externen Kommandos
  228.     tricks.doc        Tips&Tricks zur Benutzung der Shell
  229.     changes.doc        Änderungen der Shell
  230.     kompat.doc        Kompatibilität zu älteren Shell-Versionen
  231.     copying            Regelung des Kopierens der Shell
  232.     msh.doc         Benutzung der Micro-Shell
  233.     autor.doc        Anschrift des Programmautors
  234.